package com.smart.community.property.service;

import com.baomidou.mybatisplus.core.metadata.IPage;
import com.baomidou.mybatisplus.extension.plugins.pagination.Page;
import com.baomidou.mybatisplus.extension.service.IService;
import com.smart.community.property.entity.MeterReading;

import java.time.LocalDate;
import java.util.List;

/**
 * 表读数服务接口
 * @author Wu.Liang
 * @since 2024-12-21
 */
public interface IMeterReadingService extends IService<MeterReading> {
    
    /**
     * 分页查询表读数
     * @param page 分页参数
     * @param householdId 房户ID
     * @param meterType 表类型
     * @param readingStatus 读数状态
     * @return 分页结果
     * @throws Exception 统一异常
     */
    IPage<MeterReading> getMeterReadingPage(Page<MeterReading> page, Long householdId, Integer meterType, Integer readingStatus) throws Exception;
    
    /**
     * 根据房户ID查询最新的表读数
     * @param householdId 房户ID
     * @param meterType 表类型
     * @return 最新表读数
     * @throws Exception 统一异常
     */
    MeterReading getLatestReadingByHouseholdId(Long householdId, Integer meterType) throws Exception;
    
    /**
     * 批量插入表读数
     * @param readings 表读数列表
     * @return 是否插入成功
     * @throws Exception 统一异常
     */
    boolean batchInsertMeterReadings(List<MeterReading> readings) throws Exception;
    
    /**
     * 查询异常读数
     * @param communityId 社区ID
     * @param meterType 表类型
     * @param date 日期
     * @return 异常读数列表
     * @throws Exception 统一异常
     */
    List<MeterReading> getAbnormalReadings(Long communityId, Integer meterType, LocalDate date) throws Exception;
} 